home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / hotk_z60.arc / HOTKEY-Z.DOC next >
Text File  |  1989-03-31  |  38KB  |  718 lines

  1.  
  2.                       ╔═════════════════════════════════╗
  3.                       ║          HotKey-Z v6.0          ║
  4.                       ║          Documentation          ║
  5.                       ║            04-01-89             ║
  6.                       ║ Copyright 1989 Mark A. Albrecht ║
  7.                       ║       All Rights Reserved       ║
  8.                       ╚═════════════════════════════════╝
  9.  
  10.  
  11.       Prior to running this application, please read the section titled
  12.       SHAREWARE at the conclusion of this document. Also, read the
  13.       section titled HISTORY, as it may describe recently added features
  14.       undocumented elsewhere.
  15.  
  16.  
  17.                               D I S C L A I M E R
  18.  
  19.          The author, Mark A. Albrecht, makes no warranties expressed
  20.          or implied as to the quality or performance of this program,
  21.          nor its fitness for a particular purpose. The author will
  22.          not be held liable for any direct, indirect, incidental, or
  23.          consequential damages resulting from the use of this program
  24.          and *YOUR USE OF THIS PROGRAM CONSTITUTES YOUR AGREEMENT TO
  25.          THIS DISCLAIMER* as well as your release of the author from
  26.          any form of liability or litigation.
  27.  
  28.  
  29.  
  30.  
  31.          ╔══════════════╗
  32.     ═════╣ DESCRIPTION: ╠══════════════════════════════════════════════════
  33.          ╚══════════════╝
  34.  
  35.     HotKey-Z is a menu-driven interface for the popular file transfer
  36.     protocols of Chuck Forsberg's DSZ module. (DSZ is a spectacular
  37.     program. If you use DSZ beyond a trial period, please register with
  38.     Mr. Forsberg.)
  39.  
  40.     PROTOCOLS SUPPORTED: Support is provided for DSZ's X/Y/Zmodem protocols
  41.                          as well as two additional user-defined external
  42.                          protocols. Jmodem is included in the archive and
  43.                          HotKey-Z's menu provides default settings for
  44.                          using it.
  45.  
  46.     CONFIGURABLE:        All arguments/parameters to be passed to DSZ,
  47.                          cluding default download directories, may be
  48.                          specified and saved in HotKey-Z's internal config-
  49.                          uration utility.
  50.  
  51.     FILE SELECTION MENU: Files to be uploaded are selected via a point-and-
  52.                          shoot style menu. Up to 100 filespecs may be
  53.                          "tagged" for Zmodem and Ymodem batch uploads. Any
  54.                          drive and/or directory is accessible, and a
  55.                          default upload directory (where the file selection
  56.                          window will first open) may be specified and saved
  57.                          in the configuration utility.
  58.  
  59.     MOUSE SUPPORT:       All menus feature built-in mouse drivers and are
  60.                          operated using standard mouse commands.
  61.  
  62.     FAST AND EFFICIENT:  HotKey-Z is written in Turbo Pascal 5.0 (tm), with
  63.                          much of the code (including ALL screen writes)
  64.                          written in assembler language. Every function of
  65.                          HotKey-Z has been coded to provide lightning-fast
  66.                          execution, while reducing disk and RAM overhead to
  67.                          a minimum.
  68.  
  69.  
  70.  
  71.  
  72.          ╔══════════════════════╗
  73.     ═════╣ SYSTEM REQUIREMENTS: ╠══════════════════════════════════════════
  74.          ╚══════════════════════╝
  75.  
  76.     1 - IBM PC or compatible.
  77.  
  78.     2 - PC/MS DOS 3.0 or later.
  79.  
  80.     3 - Approximately 59K planar RAM in addition to that required by DSZ.
  81.  
  82.     4 - Efficiency is enhanced by using HotKey-Z on a hard disk but
  83.         performance is acceptable on a floppy.
  84.  
  85.     5 - Color or monochrome monitor.
  86.  
  87.     6 - A communication program supporting access to HotKey-Z via a hotkey
  88.         or DOS gateway.
  89.  
  90.  
  91.  
  92.  
  93.          ╔═══════════════╗
  94.     ═════╣ INSTALLATION: ╠═════════════════════════════════════════════════
  95.          ╚═══════════════╝
  96.  
  97.     Follow these instructions step-by-step and  HotKey-Z should be ready
  98.     to run.
  99.  
  100.       1. copy HotKey-Z to any directory in your DOS path;
  101.  
  102.       2. Add DSZ's pathspec to your "PATH=" command in your AUTOEXEC.BAT
  103.          file of your root directory;
  104.  
  105.       3. Add the lines "FILES=20" and "BUFFERS=20" to your CONFIG.SYS
  106.          file.
  107.  
  108.       4. Run your communications program and attach HotKey-Z to a hotkey of
  109.          the communications program. For example, Procomm Plus (R) has two
  110.          hotkeys as of this writing: "ALT-J" and "ALT-U".
  111.  
  112.       5. Run HotKey-Z and select it's main menu option "CONFIGURE". The
  113.          CONFIGURE option is comprised of three sub-options: "UPLOADS",
  114.          "DOWNLOADS", and "OTHER". When submenu option "UPLOADS" is
  115.          selected, an input menu pops up which contains edit fields in
  116.          which you will enter commandline parameters corresponding to the
  117.          five upload  protocols of HotKey-Z. When submenu option "DOWNLOADS"
  118.          is selected, an input menu pops up which contains fields
  119.          corresponding to the download protocols. Submenu option "OTHER"
  120.          contains various other configurable parameters. A summary of input
  121.          menu editing commands is listed on the status line. A detailed
  122.          description for each of the three "CONFIGURE" submenu options
  123.          ("UPLOADS", "DOWNLOADS", "OTHER") follows. Each menu option's
  124.          description follows an illustration of the menu option being
  125.          described and subdivided according to the edit fields being
  126.          described.
  127.  
  128.  
  129.  
  130.     Main option CONFIGURE, sub option UPLOADS:
  131.     ┌─────────────────────────────────────────────────────────────────────┐
  132.     │ Upload     Download    █Configure█   Information    System    Quit  │
  133.     └───────────────────────┬───────────┬─────────────────────────────────┘
  134.                             │█Uploads███│
  135.                             │ Downloads │
  136.                             │ Other     │
  137.                             └───────────┘
  138.  
  139.          Zmodem Upload Commandline:
  140.          ┌──────────────────────────────────────────────────────┐
  141.          │ dsz sz -r ^                                          │
  142.          └──────────────────────────────────────────────────────┘
  143.          This input field holds the entire commandline that will be passed
  144.          to DOS to call DSZ and initiate a Zmodem upload. A caret symbol
  145.          ("^") MUST be placed as the last parameter in this commandline, as
  146.          it symbolizes the exact position HotKey-Z will insert the name of
  147.          the file chosen from the directory display window to be uploaded.
  148.          The default commandline provided will work as-is provided you have
  149.          your modem connected through COM1.
  150.  
  151.          Ymodem Upload Commandline:
  152.          ┌──────────────────────────────────────────────────────┐
  153.          │ dsz sb -k ^                                          │
  154.          └──────────────────────────────────────────────────────┘
  155.          This input field holds the entire commandline that will be passed
  156.          to DOS to call DSZ and initiate a Ymodem upload. A caret symbol
  157.          ("^") MUST be placed as the last parameter in this commandline, as
  158.          it symbolizes the exact position HotKey-Z will insert the name of
  159.          the file chosen from the directory display window to be uploaded.
  160.          The default commandline provided will work as-is provided you have
  161.          your modem connected through COM1 (note that the default contains
  162.          the "-k" argument, which instructs DSZ to use 1k data blocks.
  163.  
  164.          Xmodem Upload Commandline:
  165.          ┌──────────────────────────────────────────────────────┐
  166.          │ dsz sx ^                                             │
  167.          └──────────────────────────────────────────────────────┘
  168.          This input field holds the entire commandline that will be passed
  169.          to DOS to call DSZ and initiate an Xmodem upload. A caret symbol
  170.          ("^") MUST be placed as the last parameter in this commandline, as
  171.          it symbolizes the exact position HotKey-Z will insert the name of
  172.          the file chosen from the directory display window to be uploaded.
  173.          The default commandline provided will work as-is provided you have
  174.          your modem connected through COM1.
  175.  
  176.          Name 1:  User Defined Protocol 1 Upload Commandline:
  177.          ┌──────┐ ┌─────────────────────────────────────────────┐
  178.          │Jmodem│ │jmodem S1 ^                                  │
  179.          └──────┘ └─────────────────────────────────────────────┘
  180.             |          |
  181.             |          |
  182.             |     This input field holds the entire commandline that will
  183.             |     be passed to DOS to call your 1st user-defined protocol,
  184.             |     (the default will execute  JMODEM.COM and instruct it to
  185.             |     send a file through COM1. A caret ("^") MUST be placed at
  186.             |     that position in the commandline where HotKey-Z should
  187.             |     insert the filename chosen from the directory display.
  188.             |
  189.          Enter the MENU name you wish to give the first of two user-defined
  190.          upload protocols. One of the characters in the menu name MUST be
  191.          capitalized, and the capitalized character MUST NOT be the same as
  192.          any capitalized character in one of the other four upload protocol
  193.          menu names (i.e., cannot be "Z", "Y", "X" or the capitalized char-
  194.          acter of the other user-defined upload protocol menu name).
  195.  
  196.          Name 2:  User Defined Protocol 2 Upload Commandline:
  197.          ┌──────┐ ┌─────────────────────────────────────────────┐
  198.          │Kmodem│ │dsz sx -k ^                                  │
  199.          └──────┘ └─────────────────────────────────────────────┘
  200.             |          |
  201.             |          |
  202.             |     This input field holds the entire commandline that will
  203.             |     be passed to DOS to call your 2nd user-defined protocol,
  204.             |     (the default will execute DSZ [.COM or .EXE] and instruct
  205.             |     it to send a file via  "1k Xmodem"  through COM1. A caret
  206.             |     ("^") MUST be placed at that position in the commandline
  207.             |     where HotKey-Z should insert the filename chosen from the
  208.             |     directory display.
  209.             |
  210.          Enter the MENU name you wish to give the second user-defined up-
  211.          upload protocol. One of the characters in the menu name  MUST  be
  212.          capitalized, and the capitalized character MUST NOT be the same as
  213.          any capitalized character in one of the other four upload protocol
  214.          menu names (i.e., cannot be "Z", "Y", "X" or the capitalized char-
  215.          acter of the other user-defined upload protocol menu name).
  216.  
  217.  
  218.  
  219.     Main option CONFIGURE, sub option DOWNLOADS:
  220.     ┌─────────────────────────────────────────────────────────────────────┐
  221.     │ Upload     Download    █Configure█   Information    System    Quit  │
  222.     └───────────────────────┬───────────┬─────────────────────────────────┘
  223.                             │ Uploads   │
  224.                             │█Downloads█│
  225.                             │ Other     │
  226.                             └───────────┘
  227.  
  228.          Zmodem Download Commandline:
  229.          ┌──────────────────────────────────────────────────────┐
  230.          │ dsz rz -r                                            │
  231.          └──────────────────────────────────────────────────────┘
  232.          This input field holds the entire commandline that will be passed
  233.          to DOS to call DSZ and initiate a Zmodem download. A caret symbol
  234.          ("^") NEED NOT be placed in this commandline. (Since Zmodem is a
  235.          batch protocol, the name is passed by the sender during transfer.)
  236.          The default commandline provided will work as-is provided you have
  237.          your modem connected through COM1. If you  wish to have the file
  238.          written to a specific directory, enter the directory's pathspec
  239.          as the last argument.
  240.  
  241.          Ymodem Download Commandline:
  242.          ┌──────────────────────────────────────────────────────┐
  243.          │ dsz rb                                               │
  244.          └──────────────────────────────────────────────────────┘
  245.          This input field holds the entire commandline that will be passed
  246.          to DOS to call DSZ and initiate a Ymodem download. A caret symbol
  247.          ("^") NEED NOT be placed in this commandline. (Since Ymodem is a
  248.          batch protocol, the name is passed by the sender during transfer.)
  249.          The default commandline provided will work as-is provided you have
  250.          your modem connected through COM1. If you wish to have the file
  251.          written to a specific directory, enter the directory's pathspec
  252.          as the last argument.
  253.  
  254.          Xmodem Download Commandline:
  255.          ┌──────────────────────────────────────────────────────┐
  256.          │ dsz rx ^                                             │
  257.          └──────────────────────────────────────────────────────┘
  258.          This input field holds the entire commandline that will be passed
  259.          to DOS to call DSZ and initiate a Ymodem download. A caret symbol
  260.          ("^") MUST be placed in this commandline, separated from the pre-
  261.          ceding commandline argument by one whitespace. The caret instructs
  262.          HotKey-Z to prompt you for the name of the file to be downloaded,
  263.          then inserts this name in the commandline at the position it finds
  264.          the caret symbol. The default commandline provided will work as-is
  265.          provided you have your modem connected through COM1. If you wish
  266.          to have the file written to a specific directory, then precede the
  267.          caret with the pathspec of the directory, e.g., "C:\DIR\^".
  268.  
  269.          Name 1:  User Defined Protocol 1 Download Commandline:
  270.          ┌──────┐ ┌─────────────────────────────────────────────┐
  271.          │Jmodem│ │jmodem R1 ^                                  │
  272.          └──────┘ └─────────────────────────────────────────────┘
  273.             |          |
  274.             |          |
  275.             |     This input field holds the entire commandline that will
  276.             |     be passed to DOS to call your first user-defined down-
  277.             |     load protocol. A caret symbol MUST be placed in this
  278.             |     commandline, separated from the preceding argument by one
  279.             |     whitespace. The caret instructs HotKey-Z to prompt you
  280.             |     for the name of the file to be downloaded, then inserts
  281.             |     this name in the commandline at the position it finds the
  282.             |     caret symbol. The default commandline provided will work
  283.             |     provided you have your modem connected through COM1 and
  284.             |     JMODEM.COM can be found. If you wish to have the file
  285.             |     written to a specific directory, precede the caret with a
  286.             |     pathspec, e.g., "C:\DIR\^".
  287.             |
  288.          Enter the MENU name you wish to give the first of two user-defined
  289.          download protocols. One of the characters in the menu name MUST be
  290.          capitalized, and the capitalized character MUST NOT be the same as
  291.          any capitalized character in one of the other four download proto-
  292.          col menu names  (i.e., cannot be "Z", "Y", "X", or the capitalized
  293.          character of the other user-defined upload protocol menu name).
  294.  
  295.          Name 2:  User Defined Protocol 2 Download Commandline:
  296.          ┌──────┐ ┌─────────────────────────────────────────────┐
  297.          │Kmodem│ │dsz rx -c ^                                  │
  298.          └──────┘ └─────────────────────────────────────────────┘
  299.             |          |
  300.             |          |
  301.             |     This input field holds the entire commandline that will
  302.             |     be passed to DOS to call your second user-defined down-
  303.             |     load protocol. A caret symbol MUST be placed in this
  304.             |     commandline, separated from the preceding argument by one
  305.             |     whitespace. The caret instructs HotKey-Z to prompt you
  306.             |     for the name of the file to be downloaded, then inserts
  307.             |     this name in the commandline at the position it finds the
  308.             |     caret symbol. The default commandline provided will work
  309.             |     provided you have your modem connected through COM1.
  310.             |     (Note that we have defined "Kmodem" as DSZ's "Xmodem" but
  311.             |     by using the "-c" argument DSZ will use CRC checking and
  312.             |     if 1k data blocks are sent, DSZ will receive 1k blocks).
  313.             |     If you wish to have the file written to a specific dir-
  314.             |     ectory, precede the caret with a path, e.g., "C\DIR\^".
  315.             |
  316.          Enter the MENU name you wish to give the second of the two user-
  317.          defined download protocols. One of the characters in the menu name
  318.          MUST be capitalized, and the capitalized character MUST NOT be the
  319.          same as any capitalized character in one of the other four down-
  320.          load protocol menu names (i.e., cannot be "Z", "Y", "X", or the
  321.          capitalized character of the other user-defined upload protocol
  322.          menu name).
  323.  
  324.  
  325.  
  326.     Main option CONFIGURE, sub option OTHER:
  327.     ┌─────────────────────────────────────────────────────────────────────┐
  328.     │ Upload     Download    █Configure█   Information    System    Quit  │
  329.     └───────────────────────┬───────────┬─────────────────────────────────┘
  330.                             │ Uploads   │
  331.                             │ Downloads │
  332.                             │█Other█████│
  333.                             └───────────┘
  334.  
  335.          Default Upload Directory:
  336.          ┌──────────────────────────────────────────────────────┐
  337.          │?:\????????\????????                                  │
  338.          └──────────────────────────────────────────────────────┘
  339.          This field holds the default disk directory where HotKey-Z will
  340.          first open the directory display window for selecting file(s) to
  341.          upload. The default is the currently logged directory. Change the
  342.          default to any valid directory on any valid drive.
  343.  
  344.                                                     ┌─┐
  345.          Sound alarm on transfer completions? [y/n] │Y│
  346.                                                     └─┘
  347.          Change the default to "N" if you do not wish to have a beep sound
  348.          upon completion of file transfers.
  349.  
  350.                                                     ┌─┐
  351.          Should screen display in monochrome? [y/n] │N│
  352.                                                     └─┘
  353.          This should default to "N" if a color display is present. If you
  354.          want HotKey-Z to display in black and white, enter "Y". If you do
  355.          have some type of color display and you want HotKey-Z to use your
  356.          color capability, enter "N".
  357.  
  358.                                                     ┌─┐
  359.          Should HotKey-Z use window whistles? [y/n] │Y│
  360.                                                     └─┘
  361.          Leave the default if you want window whistles, or change to "N" if
  362.          you can't stand them!
  363.  
  364.  
  365.     HotKey-Z should now be fully configured to run. Browse through the op-
  366.     erating instructions below, and then get to it!
  367.  
  368.  
  369.  
  370.  
  371.          ╔══════════════════╗
  372.     ═════╣ MENU MECHANICS : ╠══════════════════════════════════════════════
  373.          ╚══════════════════╝
  374.  
  375.      1. Main menu and submenu items may be selected in one of two ways:
  376.              * By using the arrow keys to move the cursor bar over
  377.                the menu selection, then pressing the carriage
  378.                return key.
  379.              * By pressing the character key corresponding to the
  380.                highlighted capitalized initial of the menu item.
  381.                (On mono displays, the capitalized letter will not
  382.                be highlighted.)
  383.  
  384.      2. Pressing the ESCAPE key at any time will return the cursor back to
  385.         the default main menu item.
  386.  
  387.      3. The main menu consists of six items: UPLOAD, DOWNLOAD, CONFIGURE,
  388.         INFORMATION, SYSTEM, and QUIT. A discussion of each follows.
  389.  
  390.  
  391.  
  392.  
  393.          ╔═════════════════════╗
  394.     ═════╣ SPECIFIC FUNCTIONS: ╠═══════════════════════════════════════════
  395.          ╚═════════════════════╝
  396.  
  397.     Major functions are listed below under illustrations of each of their
  398.     associated menu commands.
  399.  
  400.  
  401.     Main option UPLOAD, sub option ZMODEM:
  402.     ┌─────────────────────────────────────────────────────────────────────┐
  403.     │ █Upload█    Download    Configure    Information    System    Quit  │
  404.     └┬────────┬───────────────────────────────────────────────────────────┘
  405.      │█Zmodem█│ Choosing this menu item will pop up a directory display
  406.      │ Ymodem │ where you may tag up to 100 filenames to send via DSZ's
  407.      │ Xmodem │ Zmodem batch protocol. The tagged names will be written
  408.      │ Jmodem │ to a text file and DSZ will be passed it's indirection
  409.      │ Kmodem │ operator ("@") and the text file's name in place of the
  410.      └────────┘ caret symbol found in the "ZMODEM UPLOAD COMMANDLINE".
  411.  
  412.  
  413.     Main option UPLOAD, sub option YMODEM:
  414.     ┌─────────────────────────────────────────────────────────────────────┐
  415.     │ █Upload█    Download    Configure    Information    System    Quit  │
  416.     └┬────────┬───────────────────────────────────────────────────────────┘
  417.      │ Zmodem │ Choosing this menu item will pop up a directory display
  418.      │█Ymodem█│ where you may tag up to 100 filenames to send via DSZ's
  419.      │ Xmodem │ Ymodem batch protocol. The tagged names will be written
  420.      │ Jmodem │ to a text file and DSZ will be passed it's indirection
  421.      │ Kmodem │ operator ("@") and the text file's name in place of the
  422.      └────────┘ caret symbol found in the "YMODEM UPLOAD COMMANDLINE".
  423.  
  424.  
  425.     Main option UPLOAD, sub option XMODEM:
  426.     ┌─────────────────────────────────────────────────────────────────────┐
  427.     │ █Upload█    Download    Configure    Information    System    Quit  │
  428.     └┬────────┬───────────────────────────────────────────────────────────┘
  429.      │ Zmodem │ Choosing this menu item will pop up a directory display
  430.      │ Ymodem │ where you may select a file to send via DSZ's  Xmodem
  431.      │█Xmodem█│ protocol. The caret symbol found in the "XMODEM UPLOAD
  432.      │ Jmodem │ COMMANDLINE" will be replaced by the filename selected.
  433.      │ Kmodem │ The commandline will be passed to DOS for execution.
  434.      └────────┘
  435.  
  436.  
  437.     Main option UPLOAD, sub option JMODEM:
  438.     ┌─────────────────────────────────────────────────────────────────────┐
  439.     │ █Upload█    Download    Configure    Information    System    Quit  │
  440.     └┬────────┬───────────────────────────────────────────────────────────┘
  441.      │ Zmodem │ Choosing this menu item will pop up a directory  display
  442.      │ Ymodem │ where you may select a file to send via the first of two
  443.      │ Xmodem │ user-defined protocols (the default provided is Jmodem).
  444.      │█Jmodem█│ The caret symbol in the "USER DEFINED PROTOCOL 1 UPLOAD
  445.      │ Kmodem │ COMMANDLINE" will be replaced by the filename chosen and
  446.      └────────┘ passed to DOS for execution.
  447.  
  448.  
  449.     Main option UPLOAD, sub option KMODEM:
  450.     ┌─────────────────────────────────────────────────────────────────────┐
  451.     │ █Upload█    Download    Configure    Information    System    Quit  │
  452.     └┬────────┬───────────────────────────────────────────────────────────┘
  453.      │ Zmodem │ Choosing this menu item will pop up a directory  display
  454.      │ Ymodem │ where you may select a file to send via the second user-
  455.      │ Xmodem │ defined protocol (the default provided is Jmodem).   The
  456.      │ Jmodem │ caret symbol found in "USER DEFINED PROTOCOL 2 UPLOAD
  457.      │█Kmodem█│ COMMANDLINE" will be replaced by the filename chosen and
  458.      └────────┘ passed to DOS for execution.
  459.  
  460.  
  461.     Main option DOWNLOAD, sub option ZMODEM:
  462.     ┌─────────────────────────────────────────────────────────────────────┐
  463.     │  Upload    █Download█   Configure    Information    System    Quit  │
  464.     └────────────┬────────┬───────────────────────────────────────────────┘
  465.                  │█Zmodem█│ Choosing this menu item will cause HotKey-Z to
  466.                  │ Ymodem │ pass the contents of the "ZMODEM DOWNLOAD
  467.                  │ Xmodem │ COMMANDLINE" to DOS for execution.
  468.                  │ Jmodem │
  469.                  │ Kmodem │
  470.                  └────────┘
  471.  
  472.  
  473.     Main option DOWNLOAD, sub option YMODEM:
  474.     ┌─────────────────────────────────────────────────────────────────────┐
  475.     │  Upload    █Download█   Configure    Information    System    Quit  │
  476.     └────────────┬────────┬───────────────────────────────────────────────┘
  477.                  │ Zmodem │ Choosing this menu item will cause HotKey-Z to
  478.                  │█Ymodem█│ pass the contents of the "YMODEM DOWNLOAD
  479.                  │ Xmodem │ COMMANDLINE" to DOS for execution.
  480.                  │ Jmodem │
  481.                  │ Kmodem │
  482.                  └────────┘
  483.  
  484.  
  485.     Main option DOWNLOAD, sub option XMODEM:
  486.     ┌─────────────────────────────────────────────────────────────────────┐
  487.     │  Upload    █Download█   Configure    Information    System    Quit  │
  488.     └────────────┬────────┬───────────────────────────────────────────────┘
  489.                  │ Zmodem │ Choosing this menu item will cause HotKey-Z to
  490.                  │ Ymodem │ pass the contents of the "XMODEM DOWNLOAD
  491.                  │█Xmodem█│ COMMANDLINE" to DOS for execution.
  492.                  │ Jmodem │
  493.                  │ Kmodem │
  494.                  └────────┘
  495.  
  496.  
  497.     Main option DOWNLOAD, sub option JMODEM:
  498.     ┌─────────────────────────────────────────────────────────────────────┐
  499.     │  Upload    █Download█   Configure    Information    System    Quit  │
  500.     └────────────┬────────┬───────────────────────────────────────────────┘
  501.                  │ Zmodem │ Choosing this menu item will cause HotKey-Z to
  502.                  │ Ymodem │ pass the "USER DEFINED PROTOCOL 1 DOWNLOAD
  503.                  │ Xmodem │ COMMANDLINE" to DOS for execution.
  504.                  │█Jmodem█│
  505.                  │ Kmodem │
  506.                  └────────┘
  507.  
  508.  
  509.     Main option DOWNLOAD, sub option KMODEM:
  510.     ┌─────────────────────────────────────────────────────────────────────┐
  511.     │  Upload    █Download█   Configure    Information    System    Quit  │
  512.     └────────────┬────────┬───────────────────────────────────────────────┘
  513.                  │ Zmodem │ Choosing this menu item will cause HotKey-Z to
  514.                  │ Ymodem │ pass the "USER DEFINED PROTOCOL 2 DOWNLOAD
  515.                  │ Xmodem │ COMMANDLINE" to DOS for execution.
  516.                  │ Jmodem │
  517.                  │█Kmodem█│
  518.                  └────────┘
  519.  
  520.  
  521.     Main option CONFIGURE:
  522.     ┌─────────────────────────────────────────────────────────────────────┐
  523.     │  Upload     Download   █Configure█   Information    System    Quit  │
  524.     └─────────────────────────────────────────────────────────────────────┘
  525.     The "CONFIGURE" option is discussed above, under the section header
  526.     titled "INSTALLATION".
  527.  
  528.  
  529.  
  530.     Main option INFORMATION:
  531.     ┌─────────────────────────────────────────────────────────────────────┐
  532.     │  Upload     Download    Configure   █Information█   System    Quit  │
  533.     └─────────────────────────────────────────────────────────────────────┘
  534.     Choosing this menu item pops up a window displaying:
  535.                  -the current date and time;
  536.                  -the currently logged disk drive;
  537.                  -the total size in bytes of  the  currently  logged
  538.                   disk drive;
  539.                  -the bytes used on the currently logged disk drive;
  540.                  -the bytes free on the currently logged disk drive.
  541.  
  542.  
  543.     ┌─────────────────────────────────────────────────────────────────────┐
  544.     │  Upload     Download    Configure    Information   █System█   Quit  │
  545.     └───────────────────────────────────────────────────┬─────────┬───────┘
  546.     Choosing this menu item causes HotKey-Z to drop the │█Shell███│
  547.     user to the DOS system for running any DOS command. │ Command │
  548.     To return to the program, enter "EXIT".             └─────────┘
  549.  
  550.  
  551.     ┌─────────────────────────────────────────────────────────────────────┐
  552.     │  Upload     Download    Configure    Information   █System█   Quit  │
  553.     └───────────────────────────────────────────────────┬─────────┬───────┘
  554.     Choosing this menu item causes HotKey-Z to pop up   │█Shell███│
  555.     an input field in which a command may be entered    │ Command │
  556.     and passed to DOS for execution. If you wish to     └─────────┘
  557.     select a filename to embed in the command, place a caret symbol ("^")
  558.     at the position in the command where the filename should be inserted.
  559.     If a caret is found, HotKey-Z will pop up the directory display window,
  560.     where you may select a filename to replace the commandline caret (much
  561.     like the procedure for uploading files with HotKey-Z).
  562.  
  563.  
  564.     ┌─────────────────────────────────────────────────────────────────────┐
  565.     │  Upload     Download    Configure    Information    System   █Quit█ │
  566.     └─────────────────────────────────────────────────────────────────────┘
  567.     Exits the user from HotKey-Z.
  568.  
  569.  
  570.  
  571.  
  572.          ╔══════════╗
  573.     ═════╣ HISTORY: ╠══════════════════════════════════════════════════════
  574.          ╚══════════╝
  575.  
  576.          Version 1.0 - 4.8:
  577.                  * added support for batch uploads with Zmodem and  Ymodem;
  578.                  * added support for two additional user-defined protocols;
  579.                  * added support for disk file manipulation functions;
  580.                  * added support for protocol commandline modification;
  581.                  * reduced executable code size by more than 40 percent;
  582.                  * reduced planar RAM requirement by more than 50 percent;
  583.                  * eliminated several non-fatal bugs reported by users;
  584.                  * numerous subtle enhancements to improve execution speed
  585.                    and program display.
  586.  
  587.          Version 5.0 - 5.4:
  588.                  * now compiled with Turbo Pascal 5.0 (R), providing faster
  589.                    invocation, smaller executable code, and greater speed;
  590.                  * added support for a default upload directory where
  591.                    HotKey-Z will first open its UPLOAD file display window;
  592.                  * split up the CONFIGURE main menu option into three submenu
  593.                    options: one for upload parameters, one for download
  594.                    parameters, and one for everything else.
  595.                  * gave several operations back to DOS in order to further
  596.                    reduce RAM and executable code overhead (HotKey-Z 5.0 is
  597.                    at least twice as powerful as 1.0, but half the size);
  598.                  * eliminated some of HotKey-Z's code modularity to reduce
  599.                    stack usage and provide improved execution efficiency;
  600.                  * directory display file limit has been changed: HotKey-Z
  601.                    is now capable of reading up to 350 files per directory;
  602.                  * added color/monochrome display adaptor auto-detection;
  603.                  * DOS EXEC functions rewritten to ensure proper hardware
  604.                    interrupt vector restoration;
  605.                  * utilized more assembly language for even faster display;
  606.                  * input prompt procedures were completely rewritten to
  607.                    resemble those used in other popular applications;
  608.                  * HotKey-Z may now reside in a directory other than the
  609.                    directory in which the communication program resides;
  610.                  * the HOME/END keys will now cause the cursorbar to jump
  611.                    to the top/bottom of the file directory display window;
  612.  
  613.                  * you may now enter menu commands on the DOS commandline
  614.                    when invoking HotKey-Z in order to bypass the menus:
  615.                    HotKey-Z will read the commandline and interpret it as a
  616.                    string of menu initials. For example:
  617.                        ZMODEM DOWNLOAD: if you called HotKey-Z from your
  618.                                         communication program with the
  619.                                         commandline "HOTKEY-Z.EXE dz" it
  620.                                         will cause the program to begin
  621.                                         a DOWNLOAD (d) using Zmodem (z);
  622.                    Any combination of main menu and submenu commands may be
  623.                    issued from the commandline by entering the menu item's
  624.                    initial in the order you would issue them once inside
  625.                    HotKey-Z. Commandline arguments are not case-sensitive.
  626.                    If, for example, you are using Procomm Plus, and you
  627.                    have HotKey-Z set up as an external protocol (i.e.,
  628.                    called by pressing Page-Down or Page-Up), then you could
  629.                    type "dz" at Procomm Plus's commandline prompt and press
  630.                    Carriage Return and a Zmodem download would commence.
  631.                  * eliminated a bug that trashed the directory display when
  632.                    the file displayed was one megabyte or larger in size;
  633.                  * upon program termination, a null character is placed in
  634.                    the keyboard buffer to bypass your comm program's "PRESS
  635.                    ANY KEY..." prompt.
  636.                  * fixed a bug that prevented changing to some directories
  637.                    having names comprised of both letters and digits (this
  638.                    one was a dandy to track down... %$#@*&!);
  639.                  * modified directory display to resemble DOS's "DIR";
  640.                  * rewrote directory reading procedure to enhance speed;
  641.                  * added file creation date display for directory entries;
  642.                  * eliminated bug when changing display from color to mono;
  643.                  * COMPLETELY rewrote this .DOC file (improved, hopefully);
  644.  
  645.          Version 6.0:
  646.                  * eliminated use-counter (I suspect registrations will now
  647.                    drop to zero but I've grown tired of listening to the
  648.                    lowlifes complain that use-counters/delays and such make
  649.                    it difficult for them to be dishonest and dishonorable);
  650.                  * no more FILES functions per se, instead, the SYSTEM
  651.                    commands now handle those tasks;
  652.                  * reduced code size;
  653.                  * with the elimination of the use-counter, registrants no
  654.                    longer receive the latest version in the mail (i.e., the
  655.                    registration allows LEGITIMATE use of the publicly dis-
  656.                    tributed copy;
  657.  
  658.  
  659.  
  660.          ╔════════════╗
  661.     ═════╣ SHAREWARE: ╠════════════════════════════════════════════════════
  662.          ╚════════════╝
  663.  
  664.          HotKey-Z is the culmination of hundreds of hours of work. It has
  665.     matured into the most powerful DSZ interface on the market. To assist
  666.     in the continued development of HotKey-Z, the author is distributing
  667.     the publicly released version under the ShareWare concept. Use of this
  668.     application beyond a trial period (typically two weeks) requires regis-
  669.     tration. Unfortunately, I have discovered hundreds of instances where
  670.     the program has been used beyond what any reasonable person would
  671.     define as a trial period. I think this is unfair, particularly given
  672.     the nominal registration fee requested. Please support Shareware by
  673.     reimbursing authors for their time, effort, and distribution expenses.
  674.          Enclosed in this archive is the registration form for HotKey-Z,
  675.     titled "REGISTER.ME". Just print it out and fill in the lines. Mail to:
  676.  
  677.                              Mark Albrecht
  678.                              PO Box 2064
  679.                              Sioux City, IA  51104
  680.  
  681.          ╔══════════════════════════╗
  682.     ═════╣ UPDATES AND INFORMATION: ╠══════════════════════════════════════
  683.          ╚══════════════════════════╝
  684.  
  685.          Updates to and new releases of HotKey-Z may be found on this BBS
  686.     operated by Andy Flatt:
  687.  
  688.                               The NightHawk BBS
  689.                               (319) 338-2961
  690.                               Iowa City, IA
  691.  
  692.     A well-maintained and active board that is free and open to all users
  693.     from their very first call. Callers may leave messages to me (Mark
  694.     Albrecht) and I will usually respond within 24 hours. New releases
  695.     may be found in the COMM file directory. Just read or leave a message
  696.     and you may download the latest release on your very first call.
  697.  
  698.     Thank you for using and supporting HotKey-Z. I hope it fulfills a need.
  699.  
  700.          ╔══════════════════╗
  701.     ═════╣ ACKNOWLEDGEMENT: ╠══════════════════════════════════════════════
  702.          ╚══════════════════╝
  703.  
  704.     NOTE: the following acknowledgements reflect the respective copyrights
  705.           and/or trademarks known to be in existence as of this writing.
  706.  
  707.     -Thanks go to Dr. Alex Deluca for beta testing various releases of
  708.       the program, and to Andy Flatt for graciously allowing me to field
  709.       user questions and distribute HotKey-Z via his bulletin board system.
  710.  
  711.     -DSZ Copyright 1989 Omen Technology, Incorporated. All rights reserved.
  712.  
  713.     -Turbo Pascal 5.0 is a registered trademark of Borland International,
  714.      Incorporated.
  715.  
  716.     -Procomm Plus is a registered trademark of Datastorm Technologies, Inc.
  717.  
  718.